home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / bbs_door / mmess21b.zip / MPSWALL.DOC < prev    next >
Text File  |  1996-05-18  |  13KB  |  276 lines
  1. ***-=-******************-=-***-=-=-=-=-=-=-=-=-***-=-******************-=-***
  2.  
  3.                         Mystic Messages Version 2.1b!
  4.                  Written by Mike Snyder & Anna Kasl-Kissinger
  5.       (C)opyright 1996 by N-E-Ware, Mike Snyder, & Anna Kasl-Kissinger.
  6.  
  7.         Mystic Messages is FREEWARE. You may use it, free of charge.
  8.  
  9. ***-=-******************-=-***-=-=-=-=-=-=-=-=-***-=-******************-=-***
  10.  THIS SOFTWARE HAS BEEN DEVELOPED FOR USE WITH WORLDGROUP BBS SOFTWARE ONLY.
  11. ***-=-******************-=-***-=-=-=-=-=-=-=-=-***-=-******************-=-***
  12.         Special thanks to the staff of CONNECTions BBS: 316-682-7346
  13.                  Telnet to CONNECTions at: connect-bbs.com
  14. ***-=-******************-=-***-=-=-=-=-=-=-=-=-***-=-******************-=-***
  15.   NOTE: I am *NOT* the sysop of CONNECTions, I am a mere user. If you log
  16.         on to visit the file library to pick up the latest version, or you
  17.         wish to leave comments, suggestions, bug reports (or a thank-you)
  18.         please write the email to "Wyndo" and not "Sysop" please. You may
  19.         also Internet-Email me at wyndo@chaos.connect-bbs.com, or visit my
  20.         web site at http://amber.connect-bbs.com/wyndo. Have fun!
  21. ***-=-******************-=-***-=-=-=-=-=-=-=-=-***-=-******************-=-***
  22.  
  23. Welcome to Mystic Messages, a cool graffiti wall for your Galacticomm
  24. Worldgroup BBS system.
  25.  
  26. 1) Setting up Mystic Messages
  27.  
  28.    A) Unzip the MMESS*.ZIP archive into a temporary directory.
  29.       Place MPS*.* from the archive into your \WGSERV directory (or
  30.       the directory in which the MAJORBBS.EXE and related files reside).
  31.  
  32.    B) Use the CNF editor in Worldgroup to modify any Mystic Messages
  33.       settings, such as profanity allowance yes/no, and wall direction
  34.       forward or backward. You may also use the security CNF to modify
  35.       the key required to erase the wall and read writer's names. The
  36.       key defaults as "SYSOP."
  37.  
  38.    C) If you are installing as an upgrade, be sure to make note of the
  39.       values of your MPSWALL CNF options *BEFORE* you copy the archive
  40.       as described in step A. Future versions may add new CNF options,
  41.       text or ANSI's may change, and so on, so a new copy of the .MCV
  42.       and .MSG file(s) will always be included, meaning your CNF
  43.       options will be overwritten with the defaults.  Be sure to change
  44.       them back (if you are not using the defaults) after each upgrade.
  45.  
  46.    D) Use the menu tree editor to add "Mystic Messages" to your BBS.
  47.  
  48. 2) CNF options
  49.  
  50.    A) Security Access
  51.  
  52.       i. NAMEKEY: Security CNF option
  53.  
  54.          Key required to access the "Read Wall with names" option.  The
  55.          default is SYSOP. If you don't want the wall to be anonymous, you
  56.          may select a key which every user has.
  57.  
  58.      ii. RESETKEY: Security CNF option
  59.  
  60.          Key required to erase the Mystic Messages wall. The default is
  61.          SYSOP and should only be changed when you want to allow others
  62.          the ability to erase the wall. (Not recommended for everybody
  63.          to have).
  64.  
  65.     iii. LOCKOUT: Security CNF option
  66.  
  67.          This allows you to define a key, which when obtained by a user,
  68.          actually prevents that user from using Mystic Messages.  You
  69.          should never blank this out, otherwise no user could use the
  70.          module. This option should be used for "locking-out" users.
  71.  
  72.    B) Configuration options
  73.  
  74.       i. ALLOWOBS: (Allow obscene message YES/NO) Configuration CNF option
  75.  
  76.          This option will determine if "obscene" messages (messages with
  77.          obscene words) may be added to the wall. The default is NO.
  78.  
  79.      ii. BACKWARD: (Show wall backward YES/NO) Configuration CNF option
  80.  
  81.          This option will determine if the wall is displayed backward,
  82.          meaning the most recent messages are shown at the top, with the
  83.          first messages being at the bottom. The default is NO (the wall
  84.          will add new lines at the bottom).
  85.  
  86.     iii. ALLOWCOL: (Allow users the use of GLOBAL colors? YES/NO)
  87.  
  88.          This option, when set to YES (the default) will allow colors to
  89.          be used virtually anywhere -- global pages, teleconference text,
  90.          and so on are all candidates for colors! Nothing special must be
  91.          done, just key in text using color codes. It's that simple. :)
  92.          If global colors produce undesired results, you can always
  93.          disable them by setting this CNF option to NO.
  94.  
  95.          Note: Many add-on modules may already harness globals and prevent
  96.          the Mystic Messages color globals from operating. For instance, in
  97.          the base worldgroup configuration, colors will work in user pages.
  98.          Some add-on globals, however, may prevent the colors from parsing,
  99.          even in user pages.
  100.  
  101.      iv. ALLOWEXT: (Allow users the use of EXPERT colors? YES/NO)
  102.  
  103.          Mystic Messages also supports color-changes to the background,
  104.          as well as flashing. This is not readily mentioned to users
  105.          however because too much of a "good thing" can be very annoying.
  106.          If you have a problem with too much use of flashing colors and
  107.          colored backgrounds, you may set ALLOWEXT no NO to force any
  108.          messages to only allow the standard foreground color changes.
  109.  
  110.    C) Text Block configuration options
  111.  
  112.       It is not recommended that you modify the Mystic Messages text,
  113.       except as needed for simple BBS customization. Keep in mind that
  114.       each new upgrade will undo your changes.
  115.  
  116. 3) Mystic Messages Menu features
  117.  
  118.    A) (R)ead the wall
  119.  
  120.       The "R" command will read what is currently on the wall.
  121.  
  122.    B) (W)rite on the wall
  123.  
  124.       The "W" command will write a message to the wall. You will be asked
  125.       if you really want to add the line (at which time you can re-read it
  126.       for accuracy). If the ALLOWOBS CNF option is set to NO, the text will
  127.       also be checked for obscene words.
  128.  
  129.    C) (A)bout the wall
  130.  
  131.       The "A" command will display information about the wall & its authors.
  132.  
  133.    D) (I)nformation
  134.  
  135.       The "I" command will list some instructions for the wall, as well as
  136.       an explanation of the color codes users may enter in their text.
  137.  
  138.    E) (X)Exit from the wall
  139.  
  140.       This "X" command, as with any other "X" in Worldgroup, will return you
  141.       to the parent menu (leave Mystic Messages and return to the BBS).
  142.  
  143.    F) (RN) Read with names
  144.  
  145.       The "RN" command will read the wall, showing the names of the author
  146.       of each messages. Note, the "RN" command is only available to holders
  147.       of the key pointed to by CNF option NAMEKEY (default is SYSOP).
  148.  
  149.    G) (CL) Erase the wall
  150.  
  151.       The "CL" command will erase the wall and start over with a blank slate.
  152.       Note, the "CL" command is only available to holders of the key pointed
  153.       to by CNF option RESETKEY (default is SYSOP).
  154.  
  155.    H) (ER) Erase Message ###
  156.  
  157.       The "ER" option allows you to erase a single message from the wall
  158.       without wiping out the entire wall. You must also have access to
  159.       the "RN" feature to know which message # to erase (otherwise you'd
  160.       have to guess). The format would be "ER 5" to erase #5, for example.
  161.       This feature is only available to holders of the RESETKEY pointer.
  162.  
  163. 4) Mystic Messages color codes
  164.  
  165.    A) About colors:
  166.  
  167.       Mystic Messages has been designed to allow users more freedom with their
  168.       choices of colors when writing messages. For example, any part of the
  169.       line can be configured with any of 15 different colors to give each
  170.       line of text a personal, and somewhat emotional context.
  171.  
  172.       Users can learn the use of colors by referencing a chart under the
  173.       (I)nfo menu item, and again with a quick-reference line at the time
  174.       of writing a new message.
  175.  
  176.    B) Using colors:
  177.  
  178.       A two-character color code can be entered anywhere in the message, and
  179.       as many color changes may be made as space allows. For instance, the
  180.       line "`2This is `%a really `!cool `4wall `5even if I *did* write it"
  181.       is a valid color-coded line.
  182.  
  183.    C) Color Code chart:
  184.  
  185.       i. FOREGROUND COLORS (standard)
  186.  
  187.          `1 = Blue       `6 = Brown          `! = Light Cyan
  188.          `2 = Green      `7 = Light Gray     `@ = Light Red
  189.          `3 = Cyan       `8 = Dark Gray      `# = Light Magenta
  190.          `4 = Red        `9 = Light Blue     `$ = Yellow
  191.          `5 = Magenta    `0 = Light Green    `% = White
  192.  
  193.      ii. BACKGROUND COLORS (expert, requires ALLOWEXT to be YES)
  194.  
  195.          `a = Blue       `e = Magenta
  196.          `b = Green      `f = Brown
  197.          `c = Cyan       `g = Gray
  198.          `d = Red        `h = Black
  199.  
  200.     iii. FLASHING COLORS (expert, requires ALLOWEXT to be YES)
  201.  
  202.          For flashing colors, use two backwards apostrophes. `` will
  203.          turn flashing on. Another `` will turn flashing off.  As
  204.          example -->  This is normal, ``this is flashing, ``this isn't.
  205.          The foreground & background colors are retained as well.
  206.  
  207.    D) Global Colors:
  208.  
  209.       If the CNF option "ALLOWCOL" is set to YES, then users can use colors
  210.       in their messages... global pages, global actions, teleconference
  211.       pages and actions. Colors are used exactly as explained above, and
  212.       there is no need to begin the line with anything special. Just insert
  213.       color in your text where you want it!
  214.  
  215.       Note: Some add-on options may prevent colors from working in some
  216.       areas, most often the user pages and some global add-ons. In fact,
  217.       if your BBS has a lot of globals, they may be written in a manner
  218.       that prevents Mystic Messages global colors from operating at all.
  219.  
  220.    E) Examples:
  221.  
  222.       Try some of these on the wall for testing:
  223.  
  224.       `$T`6his `$i`6s `$a R`6eally `$C`6ool `$W`6all!
  225.       `8`gMystic Messages, by `%Wyndo `8and `%Akiss`8... it `%``ROCKS!
  226.       `$`dRED BOX`h  `!`1BLUE BOX
  227.  
  228.       Colors are pretty easy when you learn how to use them! :)
  229.  
  230. 5) Comments, suggestions, or just a plain "thank you"
  231.  
  232.    Mystic Messages is freeware. That's right. You may use it on your BBS
  233.    but you are not required to pay for it. What a deal, right! :) Many of
  234.    my future projects will not be freeware, however this one is.
  235.  
  236.    If you have comments or suggestions or just wanna say hi, or thank you,
  237.    you may write me email at wyndo@chaos.connect-bbs.com. If you log onto
  238.    connections, say hi to me. I'm "wyndo" online. (Note, I am NOT the sysop
  239.    of CONNECTions nor do I have any sort of sysop access. I am a mere user,
  240.    so when reporting bugs and such, be sure to write to "wyndo"). You may
  241.    call CONNECTions at 316-682-7346 or telnet in to chaos.connect-bbs.com.
  242.  
  243.    Also, visit my web site: http://amber.connect-bbs.com/wyndo for the
  244.    latest versions, news, and so on. This site houses my normal BBS doors
  245.    (non-worldgroup) as well as this and any future Worldgroup creations.
  246.  
  247. 6) Disclaimer
  248.  
  249.    I have developed and tested this software on a test board as well as
  250.    a live board with multiple users. I have taken steps to see that this
  251.    software does not cause "side-effects" to the operation of the BBS, or
  252.    create any unwanted conditions.
  253.  
  254.    However...
  255.  
  256.    The authors of this software will not take liability for any claims that
  257.    it has produced any undesired affects. If you install it and use it, you
  258.    agree to assume all responsibility for its operation and performance.
  259.    The only guarantee we make is that Mystic Messages will occupy space on
  260.    a disk. Furthermore, any distributors of this software, as long as the
  261.    software is distributed in its original form (as released from N-E-Ware
  262.    with no modifications to the archive or any files therein), cannot be
  263.    held responsible for any damages or claims of damage resulting from its
  264.    use in unmodified form. Specifically, CONNECTions BBS and its staff
  265.    take no responsibility in the results of installing and and/or using this
  266.    software package. In short, it works for us -- we hope it works for you.
  267.    If it doesn't, we will not be held liable.
  268.  
  269. 7) Thanks & Recognition
  270.  
  271.    Thanks to the staff of CONNECTions BBS, Wichita Kansas, for providing the
  272.    opportunity for me to begin developing for the Worldgroup BBS platform,
  273.    and providing a thriving BBS on which to test and distribute my software.
  274.  
  275.    Thanks to Anna Kasl-Kissinger, my partner in developing Mystic Messages.
  276.